富媒体普通报备接口

此接口为富媒体模板提供报备支持

链接

http://ip:port/mms/templateReport

参数

参数 类型 传输方式 描述
appId String Http头信息传输 用户Appid(必填)
title String 模板标题(必填)
mmsFiles String 报备的富媒体文件信息详情见示例(必填)
frames MMSFrame[] 帧的信息(必填)
sign String 签名md5(appId + appSecret+ requestTime)(必填)
requestTime long 请求时间(必填) 格式:时间毫秒数 安全验证字段,防止同一个请求重复提交; 富媒体平台根据requestTime与requestValidPeriod共同判断请求是否有效,针对无效的请求,富媒体平台响应错误; 判断方法:请求时间 + 请求有效时间>当前时间 ? 有效 : 无效;
requestValidPeriod int 请求有效时间:秒
MMSFrame
index Int 帧的顺序值(从1开始,递增)
fileName String 当前帧的文件名

示例

1、 待报备富媒体文件夹:C:\Users\Administrator\Desktop\富媒体文件;该文件夹下有两个富媒体文件:2.jpg,1.mp4

注意:如果是文本格式的文件,文本应为GBK格式

2、 将文件夹打成zip包 String filePath = ZIPUtil.compress(path).getAbsolutePath(); StringmmsFiles = Hex.encodeHexString(FileUtils.readFileToByteArray(new File(filePath)));

3、拼接json请求串

   {
	"title": "模板测试4",
	"mmsFiles": "ssss",
	"frames": [{
		"index": 1,
		"fileName": "1.mp4"
	}, {
		"index": 2,
		"fileName": "2.jpg"
	}],
	"requestTime": 1572943193839,
	"sign": "517869adb1d19acfcea35f545fa8156d",
	"requestValidPeriod": 60
}
					

4、将json串转化为UTF-8编码的byte数组Byte[] data = json.toBytes[“UTF-8”];

5、将appId放入http headhttp.setHead("appId",appId);

6、通过http post方法传输Byte[] response = http.post(url,data);详见富媒体接口demo

响应

响应数据格式为Json

参数

参数 类型 描述
code String 请求状态码,详见本文档《3.1接口状态码表》
data String 模板id
appId String 状态信息描述

示例

1、从响应流获取响应数据,并解密Byte[] data = Response.getdata();

2、将数据转换成JSON串

    {
	"code": "success",
	"data": "201911051639540000000100",
	"desc":"提交成功"
}
TOP